home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_4 / mtrai121.lha / MTRAINER.21 / MTRAINER.DOC < prev    next >
Text File  |  1994-03-08  |  19KB  |  477 lines
  1.  
  2.  
  3.            MTrainer V. 1.21 ⌐ 1994 Antonello Biancalana, IK0TOJ
  4.  
  5.  
  6.    Table of contents
  7.  
  8.         1. Introduction
  9.         2. Requirements and installation
  10.         3. Running Morse Trainer
  11.         4. Customizing Morse Trainer
  12.         5. Using Morse Trainer
  13.         6. The menus
  14.         7. File mode
  15.         8. QSO mode
  16.         9. Multi QSO mode
  17.        10. Contest mode
  18.        11. Group mode
  19.        12. Verify mode
  20.        13. The CW Output option
  21.        14. Special CW signs
  22.        15. Conclusion
  23.  
  24.  
  25.  
  26.    1 - Introduction
  27.  
  28.    Are you one of those who want to learn morse code and one of the lucky
  29.    who own an Amiga? Great! Morse trainer is for you!
  30.    Morse Trainer (MTrainer for short) is a shareware program   which lets
  31.    you to learn morse code.
  32.    But  there  is  more  than this.  Using MTrainer you can also act as a
  33.    short wave listener and facing  with  CW  reception  as  if  you  were
  34.    listening to a real QSO.
  35.    You can also filter the signal  in  order  to  cut  out  the  QRM  and
  36.    interferences.
  37.    MTrainer lets you to change the  pitch  of  the  tone,  the  speed  of
  38.    transmission and other interesting things.
  39.    MTrainer can be used to learn  CW  code  from  the  beginning  to  the
  40.    professional  level  by  means  of  groups,  just like any CW learning
  41.    course,  then,  when you will be familiar with the various signs,  you
  42.    can also "receive" and decode QSOs between two HAMs.
  43.    If you are not satisfied by MTrainer learning options,  you  can  also
  44.    create your own lessons and getting practice with them.
  45.    Infact, if you supply a normal text file,  MTrainer is able to convert
  46.    it in CW code.
  47.    In this way,  you are completely free  in  learning  CW  and  you  can
  48.    practice with the method you like most.
  49.  
  50.  
  51.  
  52.    2 - Requirements and installation
  53.  
  54.    MTrainer requires Amiga OS 2.0 or  higher,  512 Kb RAM and it  runs on
  55.    every Amiga.
  56.    At this point,  someone of you could be disappointed by the fact  that
  57.    MTrainer  does  not support Amiga OS 1.3,  but nowadays,  I think that
  58.    there is no reason in writing programs that support 1.3.
  59.    If you still have OS 1.3, I strongly suggest you to upgrade your Amiga
  60.    with the OS 2.0 for two main reasons:  the upgrade is cheap and,  most
  61.    important, you will have a more powerful Amiga.
  62.    MTrainer needs four data files to run properly. Files MT01, MT02, MT03
  63.    and  MT04  must  be  copied  in  the  same directory where MTrainer is
  64.    located.
  65.    For fast and easy installation,  you can double click on the 'Install'
  66.    icon.
  67.    The install  procedure requires  the Installer utility  distributed by
  68.    Commodore.
  69.  
  70.  
  71.  
  72.    3 - Running MTrainer
  73.  
  74.    MTrainer  can  be executed either from  the Shell or Workbench. If you
  75.    want to run it from the Shell, you just have to type MTrainer.
  76.    If you invoke MTrainer from the Shell, you will not be able to set any
  77.    option and in this case, MTrainer will use default options.
  78.    To get out the most from MTrainer, you should run it from Workbench by
  79.    double clicking on its icon.
  80.    In  this  way  you  can  also  set  some  options in order to create a
  81.    personal learning session.
  82.    Consult "Customizing MTrainer" to know more about options.
  83.  
  84.  
  85.  
  86.    4 - Customizing MTrainer
  87.  
  88.    MTrainer can be customized by means of its icon.
  89.    You can  do this by using  the "Information" option of the WorkBench's
  90.    Icon menu.
  91.    You can specify your own initial options in the tool type field.
  92.    This is the complete list of the tooltypes that can be  used  in  this
  93.    session.
  94.  
  95.    BALANCE:  This  option  is  used to set the amount of volume of the CW
  96.    tone or the noise respect the other. Using this option you can set the
  97.    amount  of noise in your lesson.  The range of the values is from -100
  98.    to 100 where -100 indicates the maximum level for the noise and no  CW
  99.    tone,  whereas  100 indicates the maximum level for the CW tone and no
  100.    noise. Default is 0.
  101.  
  102.    CWOUTPUT:  This option indicates  whether the CW output window  has to
  103.    be opened or not during the transmission. Default is NO.
  104.  
  105.    CWOUTWINDOW: This  option indicates the initial coordinates for the CW
  106.    output  window.  The format is  x/y/w/h  where x  is the  left  border
  107.    position,  y is the top border  position, w is the width  and h is the
  108.    height. Defaults: x=20, y=20, w=600, h=100
  109.    Please note that the coordinates are not enclosed in double quotes.
  110.    
  111.    FILTER:  This option sets the  width of the filter used to cut out the
  112.    noise.  There are  four kinds  of filters:  6KHz,  2.2KHz,  1.8KHz and
  113.    500Hz. Default is 500Hz.
  114.  
  115.    GROUPS: This option  is used to set the default number of groups to be
  116.    generated  when  MTrainer  operates  in  group mode.  The range of the
  117.    values is from 1 to 100. Default is 10 groups.
  118.  
  119.    LEVEL:  This option sets the difficulty  level for the group mode. The
  120.    range of values is from 1 to 26. Default is 12.
  121.  
  122.    MODE:  This  option  sets  the initial MTrainer mode. Possible  values
  123.    are: FILE, QSO, MULTIQSO, CONTEST and GROUPS. Default is GROUPS.
  124.  
  125.    MULTIQSODELAY: This option sets the  maximum delay between QSOs.  This
  126.    value is used only in  the  MultiQSO mode. The delay must be specified
  127.    in seconds.  The minimun delay used is always 10 seconds and the value
  128.    specified in this tooltype cannot be lesser than it. Default is 60.
  129.  
  130.    CONTESTDELAY: This  option sets  the maximun  delay between  contest's
  131.    QSOs in Contest mode. The delay is specified in seconds.
  132.    The minimum delay allowed is 1 and the default is 3.
  133.    
  134.    SPEED: This option sets the speed of transmission and it indicates the
  135.    CW signs sent per minute.  The range of values is from 10 to  200  cpm
  136.    (characters per minute). Default is 40 characters per minute.
  137.  
  138.    TONE:  This option is used to set the waveform of the CW tone, that is
  139.    the timbre of the CW tone. There are four kinds of tone: SINE, SQUARE,
  140.    SAWTOOTH and CWTONE. Default is CWTONE.
  141.  
  142.    TONEFREQ:  This option sets the CW tone's frequency, that is the pitch
  143.    of  the  tone.  The  range  of  the  values is from 300 to 1400 Hertz.
  144.    Default is 800 hertz.
  145.  
  146.    VERIFY:  This option  sets the editor or the viewer used to verify the
  147.    last lesson.  You must supply the path and the name of the program you
  148.    wish to use. Default is "c:ed".
  149.  
  150.    VOLUME:  This option allows you to set the initial volume for both  CW
  151.    tone  and noise.  The range of the values is from 0 to 64.  Default is
  152.    50.
  153.  
  154.  
  155.  
  156.    5 - Using MTrainer
  157.  
  158.    Once started,  MTrainer opens its own window in the WorkBench screen.
  159.    At the left of the window there are four sliders. The volume slider is
  160.    used to set the output volume for both noise and morse signal.
  161.    The balance gadget lets you to determine the amount of noise and morse
  162.    signal.  A  value  of  zero  means  the same amount of noise and morse
  163.    signal, that is they are perfectly balanced.
  164.    A  positive  value  means  that  morse  signal is stronger than noise,
  165.    whereas a negative value means noise stronger that morse signal.
  166.    If  you  want  to  have a pure morse signal,  that is a signal with no
  167.    noise, you have to set balance to 100 by positioning the gadget on the
  168.    far right.
  169.    The tune slider allows you to set the pitch of the CW  tone.  You  can
  170.    set CW tone from 300 Hertz to 1400 Hertz.
  171.    The speed slider  lets  you  to  set  the  speed  of  transmission  in
  172.    characters  per  minute.  You  can  set  this  value  from  10  to 200
  173.    characters per minute.
  174.    At the right of the  window there is a  recessed box where you can set
  175.    the filter band width and the timbre of the CW tone.
  176.    You  can  consider  the  filter  gadgets just like the filters of your
  177.    transceiver.  There are  four  kinds  of  filter  and  every  one  can
  178.    attenuate noise by means of its band width.
  179.    The higher the band width, the higher the confusion in the reception.
  180.    Using these gadgets and the balance slider,  you can simulate a lot of
  181.    situations, from the ridiculously easy to the extremely hard.
  182.    The  Filter can be set in  one of the following band widths:  5 Hertz,
  183.    1.8 Hertz, 2.2 Hertz and 6 Kilohertz.
  184.    The  other gadget placed inside the recessed box is used to set the CW
  185.    tone timbre.  There are  a  lot  of  people  who  learns  CW  using  a
  186.    particular tone and feels having no problem with CW.
  187.    Because of our auditory system,  someone  could  discover  himself  or
  188.    herself absolutely unable to decode CW sent with different timbres.
  189.    This option is useful to get practice with the most used waveforms for
  190.    CW in order to become familiar with the various situations.
  191.    There are four kinds of timbres:  Sinusoidal wave (sine), square wave,
  192.    sawtooth wave and CW Tone.
  193.    In the bottom of the window there are  three  buttons  where  you  can
  194.    start, test and stop the reception.
  195.    The start button is used to start the lesson using the selected mode.
  196.    The test button lets you to control and set the  CW  reception  before
  197.    starting the lesson.
  198.    The stop button stops any action in progress, that is the test session
  199.    and the lesson itself.
  200.    Any option can be set during the lesson  or  the  test  session,  this
  201.    means  that  you  can  alter  filter,  volume,  balance  and any other
  202.    parameter during the CW transmission.
  203.    The test button has been provided for this purpose, that is to prepare
  204.    the working environment before starting the lesson for real.
  205.    Below  the recessed box there  is a recessed gadget that MTrainer uses
  206.    to show the current mode and the current status.
  207.    If you want to pause MTrainer  during the CW transmission, you have to
  208.    click outside of any MTrainer window (either  main window or CW output
  209.    window).
  210.    To resume Mtrainer after a pause,  you have to re-activate one  of the
  211.    MTrainer's windows by clicking inside of it.
  212.  
  213.  
  214.  
  215.    6 - The menus
  216.  
  217.    MTrainer has only three menus where you can choose some options. Using
  218.    these menus you can also set the working mode.
  219.  
  220.    6.1 - Project menu
  221.  
  222.    - New:  This  item  creates a new  session in the  selected mode.  For
  223.    example,  if your  current  mode  is QSO,  when  you choose  this item
  224.    MTrainer will create a new QSO according to the current settings.
  225.  
  226.    - Start: Starts the lesson in the selected mode.
  227.  
  228.    - Stop: Stops any CW transmission.
  229.  
  230.    - Test: Lets you to test the settings of the CW transmission.
  231.  
  232.    - About: Shows the copyright notice about Morse Trainer and some other
  233.    information about the author.
  234.  
  235.    - Quit:  Lets you to quit Morse Trainer. You can also quit MTrainer by
  236.    clicking on the window close gadget.
  237.  
  238.    6.2 - Mode menu
  239.  
  240.    - File:  This mode lets you choose a text file to transmit.  When  you
  241.    choose this option,  a file requester will appear on the screen asking
  242.    for a file to load.
  243.  
  244.    - QSO: This mode generates a QSO to be transmitted during the lesson.
  245.    Using this option, you can act as a short wave listener listening at a
  246.    CW QSO between two HAMs.
  247.  
  248.    - MultiQSO:  This mode is similar to the QSO mode except that it sends
  249.    QSOs until you press the Stop button.
  250.    The delay between QSOs is set by the MULTIQSODELAY tooltype.
  251.  
  252.    - Groups:  This mode is used to generate groups of signs at  different
  253.    difficulty levels.
  254.  
  255.    - Verify:   This  option  allows  you  to  verify   the  last   lesson
  256.    transmitted.  This option is used to check out how many errors you did
  257.    during the reception.  When selected, a file viewer will appear on the
  258.    screen showing the contents of the last lesson. The file viewer or the
  259.    file  editor  to be  used by this option must be specified in the tool
  260.    type VERIFY.
  261.  
  262.    6.3 - Options menu
  263.  
  264.    - CW Output:   When  this option  is  on,  everytime  you  start a  CW
  265.    transmission, a  window will be  opened on the screen  showing the  CW
  266.    signs as they are sent out.
  267.    This is useful in learning new CW signs. During the reception you will
  268.    be able to see the corresponding sign while it is sent out. The output
  269.    window can be dragged and sized at your ease. 
  270.  
  271.  
  272.  
  273.    7 - The file mode
  274.  
  275.    Using  this  mode  you  can  load  any  text  file to be sent by Morse
  276.    Trainer.
  277.    As  you  select this mode,  a file requester will appear on the screen
  278.    asking for a file to load.
  279.    In  this  way  you can create your own lessons by preparing files with
  280.    your groups or whatever you want.
  281.    If you want to use special CW  signs such as "wait",  "silent key" and
  282.    so, please consult the chapter "Special CW signs.
  283.  
  284.  
  285.  
  286.    8 - The QSO mode
  287.  
  288.    This mode lets you to act as a short wave listener listening at a  QSO
  289.    between two HAMs.
  290.    Every time you select this mode,  MTrainer will generate a QSO between
  291.    two HAMs calling from various parts of the world.
  292.    Because the QSO is generated in a random base,  you could also hear  a
  293.    W9  calling from San Francisco,  California or a I2 calling from Rome,
  294.    Italy.
  295.    This is not a bug, this is just normal for MTrainer.  Remember this is
  296.    a training program intended for people who want to learn CW code,  and
  297.    this apparent bug is not relevant.
  298.    A HAM from San Francisco calling from the USA area number 9 (you  know
  299.    California state is assigned to USA area number 6),  is not a relevant
  300.    error for training purposes.
  301.    Consider  this  aspect when you will be going to receive QSO generated
  302.    by MTrainer.
  303.    A  QSO  generated  by  MTrainer  is a typical CW QSO concerning names,
  304.    QTHs,  RIGs,  antennas and other things that HAMs like  to  send  each
  305.    other.
  306.    At the end of the QSO you can verify  what  you  heard  by  using  the
  307.    verify option of the mode menu.
  308.    When you look first at the written QSO, you could be surprised by some
  309.    "strange" characters.
  310.    MTrainer uses some  characters to indicate special  CW  signs  such as
  311.    "wait", "silent key" and so.
  312.    Please read the chapter "Special CW signs" to know more about them.
  313.  
  314.  
  315.  
  316.    9 - The multi QSO mode
  317.  
  318.    This mode is quite  similar to the QSO mode except that it creates  and
  319.    sends QSOs until the user does not select the Stop button.
  320.    At the end of every QSO MTrainer will wait for a while before sending a
  321.    new QSO.
  322.    The amount of wait time is specified by the MULTIQSODELAY tooltype.
  323.    The wait time will be between 10 seconds and the time specified  in the
  324.    MULTIQSODELAY tooltype.
  325.  
  326.  
  327.  
  328.    10 - The contest mode
  329.  
  330.    This mode lets you to listen at a contest.
  331.    The contest mode is very useful to getting practice with critical CW
  332.    situations because the exchange of information is very quick.
  333.    This mode is also useful to getting practice with numbers.
  334.    The amount of wait time before a new HAM station starts transmitting
  335.    is specified by the CONTESTDELAY tooltype.
  336.  
  337.  
  338.    11 - The group mode
  339.  
  340.    This  mode  is  used  to  generate  groups of signs just as typical CW
  341.    courses and every group is made of 8 rows by 5 signs.
  342.    After  selecting  this  mode,  a  little  requester will appear on the
  343.    screen.
  344.    Using  this  requester you can choose the number of groups to generate
  345.    and the difficulty level of the groups.
  346.    When  you will start the transmission,  a sequence of three V  will be
  347.    sent.
  348.    This  sequence  is  just  to  warn  you  about  the  beginning  of the
  349.    transmission of groups and it does not belong to them.
  350.    Every  level is featured by its own signs  and these are those used in
  351.    all the levels available in MTRainer.
  352.    Please  note  that a higher level uses its own signs and all the signs
  353.    used in the lower levels except for levels 23 and 25.
  354.  
  355.    Level  1: AN
  356.    Level  2: R
  357.    Level  3: D
  358.    Level  4: W
  359.    Level  5: K
  360.    Level  6: U
  361.    Level  7: G
  362.    Level  8: E
  363.    Level  9: L
  364.    Level 10: BF
  365.    Level 11: ITM
  366.    Level 12: C
  367.    Level 13: X
  368.    Level 14: S
  369.    Level 15: O
  370.    Level 16: V
  371.    Level 17: Q
  372.    Level 18: Y
  373.    Level 19: H
  374.    Level 20: J
  375.    Level 21: P
  376.    Level 22: Z
  377.    Level 23: Only numbers
  378.    Level 24: Numbers and letters
  379.    Level 25: Only special CW signs
  380.    Level 26: letters, numbers and special CW signs
  381.  
  382.  
  383.  
  384.    12 - The verify mode
  385.  
  386.    This mode lets you to verify the last session used in Morse Trainer.
  387.    This  is  done by using a file viewer or a file editor as specified in
  388.    the VERIFY tool type.
  389.    If no viewer or editor has been specified, MTrainer will use "c:ed" as
  390.    its default verifier.
  391.  
  392.  
  393.  
  394.    13 - The CW output option
  395.  
  396.    When  this option is on, everytime MTrainer sends CW signals,  it will
  397.    open a window on  the screen showing the  CW transmission, just like a
  398.    "teletype".
  399.    This option is useful when you want to learn new CW signals by hearing
  400.    the signals and seeing the corresponding characters.
  401.    The window  can be dragged and  sized at  your ease and everytime that
  402.    the  window is  opened on  the  screen,  MTrainer will use  your  last
  403.    settings.
  404.  
  405.  
  406.  
  407.    14 - Special CW signs
  408.  
  409.    MTrainer uses some ASCII characters as special CW signs.
  410.    The following  table shows the special CW signs  used in MTrainer  and
  411.    the equivalent ASCII character.
  412.  
  413.    CW Sign     Meaning                 ASCII
  414.    -------     -------                 -----
  415.  
  416.      BT        Dash                      -
  417.      .         Fullstop                  .
  418.      /         Slash                     /
  419.      CL        End of transmissions      :
  420.      AS        Wait                      ;
  421.      AR        End of message            <
  422.      KN        Key now                   =
  423.      SK        Silent key                >
  424.      ?         Question mark             ?
  425.      Error     Error                     @
  426.      FG        Final greeting            [
  427.      BK        Break                     \
  428.  
  429.  
  430.  
  431.    15 - Conclusion
  432.  
  433.    I hope you will like MTrainer and I hope  MTrainer  can  help  you  in
  434.    getting practice with CW code.
  435.    I should like  to thank my  dear friend IK0EFR Andrea  for his support
  436.    and for his precious suggestions during the development of MTrainer.
  437.    I should  also like to thank him  because  without his precious help I
  438.    would have never become a HAM.
  439.    I also want to thank Commodore for giving us this  fantastic  computer
  440.    whose name is AMIGA.
  441.  
  442.    Send your contributions and suggestions to:
  443.  
  444.        Antonello Biancalana, IK0TOJ
  445.        Via Girolamo Diruta, 69
  446.        I-06132  San Sisto (Perugia) ITALY
  447.  
  448.    or if you wish, you can contact me through fidonet at 2:335/412.3
  449.  
  450.    MTrainer is SHAREWARE.  If you use  this program  and you think  it is
  451.    useful, please send your contribution to my address.
  452.    The suggested price for this program is 10 (ten) US dollars. 
  453.    MTrainer  may be freely  copied  and  distributed,  provided  that any
  454.    distribution  is accompanied by this documentation file.  MTrainer can
  455.    be used for any non-commercial or non-profit-making purpose.
  456.    Permission  for commercial  or profit-making purposes  may be obtained
  457.    from the author. 
  458.  
  459.    Have fun with your Amiga and with CW!
  460.  
  461.    Thank you for supporting Morse Trainer.
  462.  
  463.    Perugia, 8th March, 1994
  464.  
  465.        Antonello Biancalana, IK0TOJ
  466.        member of the ADSP (Amiga Developers Support Program)
  467.  
  468.  
  469.    Morse Trainer 1.21 is copyright 1994 by Antonello Biancalana, IK0TOJ
  470.  
  471.    Amiga is a registered trademark of Commodore-Amiga, Inc.
  472.  
  473.    WorkBench is a registered trademark of Commodore-Amiga, Inc.
  474.  
  475.    Installer is copyright 1991-1993 by Commodore-Amiga, Inc.
  476.  
  477.